/*
 * gettimeofday.c
 *	  Win32 gettimeofday() 替代实现
 *
 * src/port/gettimeofday.c
 *
 * Copyright (c) 2003 SRA, Inc.
 * Copyright (c) 2003 SKC, Inc.
 *
 * Permission to use, copy, modify, and distribute this software and
 * its documentation for any purpose, without fee, and without a
 * written agreement is hereby granted, provided that the above
 * copyright notice and this paragraph and the following two
 * paragraphs appear in all copies.
 *
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE TO ANY PARTY FOR DIRECT,
 * INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING
 * LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS
 * DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED
 * OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 * THE AUTHOR SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS ON AN "AS
 * IS" BASIS, AND THE AUTHOR HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE,
 * SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 */

#include "c.h"

#include <sys/time.h>

/* FILETIME of Jan 1 1970 00:00:00, the PostgreSQL epoch */
static const unsigned __int64 epoch = UINT64CONST(116444736000000000);

/*
 * FILETIME表示自
 * 1601年1月1日（UTC）以来的100纳秒间隔的数量。
 */
#define FILETIME_UNITS_PER_SEC	10000000L
#define FILETIME_UNITS_PER_USEC 10

/*
 * GetSystemTimeAsFileTime和GetSystemTimePreciseAsFileTime具有相同的
 * 签名，因此我们可以存储指向我们找到的任何一个的指针。这
 * 是指针的类型。
 */
typedef VOID(WINAPI * PgGetSystemTimeFn) (LPFILETIME);

/* 一次性初始化函数，必须匹配该签名。 */
static void WINAPI init_gettimeofday(LPFILETIME lpSystemTimeAsFileTime);

/* 在运行时选择的函数的存储 */
static PgGetSystemTimeFn pg_get_system_time = &init_gettimeofday;

/*
 * 一次性初始化。 确定是否可用GetSystemTimePreciseAsFileTime，
 * 如果可用，则计划使用它；如果不可用，则回退到
 * GetSystemTimeAsFileTime。
 */
static void WINAPI init_gettimeofday(LPFILETIME lpSystemTimeAsFileTime)
{
	/*
	 * 因为可以保证kernel32.dll已经链接到我们的
	 * 地址空间中，所以我们不需要加载它并担心
	 * 之后关闭它，所以我们不使用Pg的dlopen/dlsym()封装。
	 *
	 * 我们只需查找GetSystemTimePreciseAsFileTime的地址（如果
	 * 存在）。
	 *
	 * 虽然我们可以查找Windows版本并跳过这个在Windows
	 * 8 / Windows Server 2012以下的版本上，但这样做没有太大意义，
	 * 并且确定Windows版本本身也有些与Windows版本和开发SDK
	 * 相关...
	 */
	pg_get_system_time = (PgGetSystemTimeFn) GetProcAddress(GetModuleHandle(TEXT("kernel32.dll")),
															"GetSystemTimePreciseAsFileTime");
	if (pg_get_system_time == NULL)
	{
		/*
		 * 从GetLastError()获取的预期错误是ERROR_PROC_NOT_FOUND，如果
		 * 函数不存在。 不应该发生其他错误。
		 *
		 * 我们不能在这里报告错误，因为这可能在
		 * 前端代码中运行；即使我们在后端，如果我们收到一些
		 * 意外错误，太早了也无法elog(...)。 另外，这不是一个
		 * 严重的问题，因此无论失败发生的原因是什么，只需
		 * 默默回退到GetSystemTimeAsFileTime。
		 */
		pg_get_system_time = &GetSystemTimeAsFileTime;
	}

	(*pg_get_system_time) (lpSystemTimeAsFileTime);
}

/*
 * 时区信息存储在内核外部，因此不再使用tzp。
 *
 * 注意：此函数不用于Win32高精度计时目的。请参阅
 * elapsed_time()。
 */
int gettimeofday(struct timeval *tp, struct timezone *tzp)
{
	FILETIME	file_time;
	ULARGE_INTEGER ularge;

	(*pg_get_system_time) (&file_time);
	ularge.LowPart = file_time.dwLowDateTime;
	ularge.HighPart = file_time.dwHighDateTime;

	tp->tv_sec = (long) ((ularge.QuadPart - epoch) / FILETIME_UNITS_PER_SEC);
	tp->tv_usec = (long) (((ularge.QuadPart - epoch) % FILETIME_UNITS_PER_SEC)
						  / FILETIME_UNITS_PER_USEC);

	return 0;
}
